home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_8 / issue_06 / risc_os / Wimp / !Summary next >
Encoding:
Text File  |  1988-12-06  |  4.6 KB  |  201 lines

  1. > Wimp.!Summary
  2.  
  3. Instructions
  4. ------------
  5.  
  6. The documents in this directory have been formatted using a text editor,
  7. rather than a word processor.  Please think carefully before needlessly
  8. printing them out - they can be read just as easily on the screen, and the
  9. easiest way to find things is to use Twin's FIND command, rather than
  10. scanning up and down bits of paper.
  11.  
  12. Come on, you guys - whatever happened to the paperless office!
  13.  
  14.  
  15. List of Wimp documents
  16. ----------------------
  17.  
  18.         Wimp.Colours            ; mode-independent bits
  19.         Wimp.Desktop            ; how the Desktop module works
  20.         Wimp.Drag
  21.         Wimp.Errors
  22.         Wimp.Guidelines
  23.         Wimp.IconBar
  24.         Wimp.Icons
  25.         Wimp.Install            ; how to install an application
  26.         Wimp.Menus
  27.         Wimp.Messages
  28.         Wimp.Misc
  29.         Wimp.Obey               ; *command files
  30.         Wimp.Pointer            ; programming the mouse pointer
  31.         Wimp.SprExtend          ; included here for convenience
  32.         Wimp.Sprites
  33.         Wimp.Switcher
  34.         Wimp.Text               ; plus keyboard handling & escape
  35.  
  36.  
  37. Wimp.Colours
  38. ------------
  39.         Wimp_SetMode
  40.         Wimp_SetPalette
  41.         Wimp_ReadPalette
  42.         Wimp_ReadPixTrans
  43.         Wimp_SetCaretPosition
  44.         Wimp_SetColour
  45.         Wimp_TextColour
  46.         Wimp_SetFontColours
  47.         Wimp_PlotIcon
  48.  
  49.         *Configure WimpMode <number>
  50.         *WimpPalette <filename>
  51.  
  52.  
  53. Wimp.Desktop
  54. ------------
  55.         Wimp_Initialise
  56.         Wimp_CloseDown
  57.         Service_WimpCloseDown
  58.         Wimp_StartTask
  59.  
  60.         *Desktop
  61.         Service_StartWimp
  62.         Service_StartedWimp
  63.         Wimp_Poll: reason code 18 (message) action 0 (global closedown)
  64.  
  65.  
  66. Wimp.Drag
  67. ---------
  68.         Wimp_DragBox            (new reason codes)
  69.  
  70.         *Configure WimpFlags <number>
  71.  
  72.  
  73. Wimp.Errors
  74. -----------
  75.         Wimp_ReportError
  76.  
  77.         UpCall handling
  78.         Service_WimpReportError
  79.  
  80.  
  81. Wimp.Guidelines
  82. ---------------
  83.         Miscellaneous advice
  84.         SWI calls in wrong context
  85.         Invalid access to other tasks' windows
  86.  
  87.  
  88. Wimp.IconBar
  89. ------------
  90.         Wimp_CreateIcon        (window handle = -1 or -2)
  91.         Wimp_DeleteIcon
  92.         Wimp_SetIconState
  93.         Wimp_GetIconState
  94.         Wimp_GetPointerInfo
  95.         Wimp_Poll: reason code 6 (Mouse_Click)
  96.  
  97.  
  98. Wimp.Icons
  99. ----------
  100.         system icons
  101.         scrollable icons
  102.         validation strings
  103.         sprite + text icons
  104.         button type 9
  105.         button type 11
  106.         inverting sprites
  107.  
  108.  
  109. Wimp.Install
  110. ------------
  111.         *Obey                   (see also Wimp.Obey)
  112.         *WimpSlot
  113.  
  114.  
  115. Wimp.Menus
  116. ----------
  117.         Wimp_CreateMenu
  118.         Wimp_CreateSubMenu
  119.         Wimp_Poll:  reason code 9  (Menu_Selection)
  120.         Wimp_Poll:  reason code 17 (Menu_Warning message)
  121.  
  122.  
  123. Wimp.Messages
  124. -------------
  125.         Wimp_SendMessage
  126.         Wimp_Poll:  reason codes 17,18,19
  127.         Wimp_TransferBlock
  128.  
  129.  
  130. Wimp.Misc
  131. ---------
  132.         Wimp_BlockCopy
  133.         Wimp_GetWindowOutline
  134.         Wimp_PollIdle
  135.         Wimp_CommandWindow
  136.         Wimp_ReadSysInfo
  137.  
  138.         window flags bit 10 ==> don't use colour translation table
  139.         window flags bit 11 ==> don't open any other windows below this one
  140.         window flags bit 12 ==> grab 'hot keys' (see Wimp_ProcessKey)
  141.         window areaCBptr =1 ==> use common sprite area
  142.         window bounds           changed to cover whole screen
  143.                                 window min x,y can be supplied
  144.         Service_MouseTrap       provided for mouse-exec utilities
  145.  
  146.  
  147. Wimp.Obey
  148. ---------
  149.         *Obey <filename>
  150.  
  151.  
  152. Wimp.Pointer
  153. ------------
  154.         *Pointer
  155.         Wimp_SetPointerShape
  156.         Wimp_SpriteOp (36 = SetPointerShape)
  157.  
  158.  
  159. Wimp.SprExtend
  160. --------------
  161.         OS_SpriteOp codes 35,36, 50,51,52,53, 60,61
  162.                 SpriteReason_AppendSprite
  163.                 SpriteReason_SetPointerShape
  164.                 SpriteReason_PlotMaskScaled
  165.                 SpriteReason_PaintCharScaled
  166.                 SpriteReason_PutSpriteScaled
  167.                 SpriteReason_PutSpriteGreyScaled
  168.                 SpriteReason_SwitchOutputToSprite
  169.                 SpriteReason_SwitchOutputToMask
  170.         OS_ReadVduBlockSize
  171.  
  172.  
  173. Wimp.Sprites
  174. ------------
  175.         Wimp_SpriteOp
  176.         Wimp_BaseOfSprites
  177.  
  178.         *IconSprites <filename>
  179.         window areaCBptr = 1 ==> use common sprite area
  180.           icon areaCBptr = 1 ==> use common sprite area
  181.  
  182.  
  183. Wimp.Switcher
  184. -------------
  185.         memory management
  186.         Wimp_SlotSize
  187.         interactive slot resizing
  188.         Wimp_ClaimFreeMemory
  189.  
  190.  
  191. Wimp.Text
  192. ---------
  193.         Wimp_ProcessKey
  194.         Wimp_Poll:  reason code 11  (Lose_Caret)
  195.         Wimp_Poll:  reason code 12  (Gain_Caret)
  196.         Wimp_SetCaretPosition
  197.  
  198.         system font size
  199.         escape handling
  200.  
  201.